===================================================

		Wearable Lanterns

		Candle Lanterns of the North Add-On

	For The Elder Scrolls V: Skyrim

		Author: Chesko

		Contact:	Forums - Chesko
				E-mail - chesko.tesmod@gmail.com

===================================================

This mod is an add-on for Wearable Lanterns that allows you to pick up and use the 1400+ Candle Lanterns found throughout Skyrim. The Candle Lanterns can also be crafted by combining Candles (made from honeycomb, spriggan sap, or troll fat), and a lantern.

Candle Lanterns burn for 8 minutes* by default before burning out. When it burns out, it will return an empty Lantern to your inventory. You can add more candles to your lantern by clicking Candles in your inventory, provided you have crafted some (see below).

////////////////REFILLING YOUR CANDLE LANTERN:

You can click on Candles in your inventory to add more candles to an empty lantern while out adventuring. You do not need to use a forge to combine them.

////////////////FEATURES:

While I strove to make Candle Lanterns of the North as feature-rich as possible, in some cases, not all Wearable Lantern features could be implemented at this time.  Here is a breakdown of features supported by Candle Lanterns:

Modifiable Brightness: 			NO
Dimming:				NO
Drop Lit Lantern:			YES
Auto-Drop (according to setting):	YES
Requires fuel:				YES*
Follower Support:			YES**

* You can alter the duration of Candle Lanterns by typing the console command "set CandleLanternDuration to X", where X is the number of minutes you would like your candle lantern to last. A very large number would make your candle lantern's duration effectively unlimited. I opted for a shorter duration by default because of how plentiful these lanterns are throughout Skyrim, and to incentivize using other lightsources. Lightsources used by followers last forever.

** Follower support is not as fool-proof as other lanterns in Wearable Lanterns. Ordinarily, Wearable Lanterns actively prevents you from giving your follower more than one lantern. Here, I instead simply print a warning if I see that you have given a Candle Lantern to a follower that already has a lantern or a torch. MAKE SURE to only give your follower ONE LIGHTSOURCE (lantern, torch) to ensure the best behavior.

Followers will not automatically put away Candle Lanterns when sneaking.

////////////////CRAFTING RECIPES:

The following crafting recipes have been added to Forges:

1x Candles - Requires 1x Spriggan Sap
2x Candles - Requires 1x Troll Fat
4x Candles - Requires 1x Honeycomb

1x Candle Lantern - Requires 1x Candles + 1x Lantern (NOTE: You can also combine them by clicking on Candles in your inventory)

////////////////HOW IT WORKS:

I have used the Find-Replace function of the Creation Kit to replace every candle lantern static object with a new activator that looks exactly the same. This will allow you to pick up the hundreds of Candle Lanterns located in every house, dungeon, city, bandit camp, and everywhere in between.

When you pick up a Candle Lantern, my script tries to find and turn off a nearby light object known to be used by Candle Lanterns. This is done on a best-effort basis and may not always work. It will also attempt to turn off any glow effects that it finds.

After 7 game days, any Candle Lanterns you have taken will respawn, so you don't have to worry about doing permanent damage to the atmosphere of the game just because you wanted to take a lantern. It will also turn back on any lights and effects it turned off when it was taken.

////////////////INSTALLATION:

PICK ONE: 
Chesko_WearableLantern_Candle.esp (Skyrim only)
Chesko_WearableLantern_CandleDG.esp (Dawnguard compatible)

If you opt for the No BSA version of Wearable Lanterns and/or Candle Lanterns of the North, you may get a message warning you about overwriting the following files:

_WL_lampgeneric01.dds
_WL_lampgeneric01_n.dds

These are OK to overwrite. They are simply a copy of the lantern textures that are packaged with Wearable Lanterns. For compatibility reasons I needed to redistribute them with this add-on as well.

////////////////UNINSTALLATION:

Waiting 8 days to be positive that all light and glow effects are turned back on is probably a good idea.

After that, you should be able to just uninstall it directly. I have tested a save game that had Candle Lanterns of the North installed, I uninstalled it, and when reloading that save game, all of the static lantern objects were right back where they were. Your experience should be the same.

////////////////REQUIREMENTS:

REQUIRES Wearable Lanterns 2.2 or newer.
REQUIRES Skyrim 1.7.7.0 or newer.

Load order should not matter, but it's probably a good idea to load this after Wearable Lanterns.

////////////////KNOWN ISSUES:

* I do not forcibly prevent you from giving your follower more than one lantern when one of those lanterns is a Candle Lantern. I do print a warning to the screen.

* Followers will not automatically put away Candle Lanterns when sneaking.

* The timer for the duration for Candle Lanterns is global; by that I mean, the timer does not follow the individual lanterns themselves. If you use a lantern for 6 minutes, and drop it, and get another one, it will not last 8 minutes (by default), it will last 2. The one you dropped (or any other you acquire) will then in turn last another 8 minutes. The timer only runs when you have a Candle Lantern equipped.

////////////////TROUBLESHOOTING:

"I equipped a candle lantern, but I played a strange arm animation and/or I teleport somewhere."

My script(s) failed to run OR you do not have Wearable Lanterns 2.2 installed, which is required. Verify that you are using Skyrim version 1.7.7.0 or newer. Also verify that you are not using Script Dragon, which has been known to cause certain events in my mods to fail to trigger. If you continue to experience this behavior (you play a "table pick up" animation when equipping a Candle Lantern), roll back to an earlier save before you installed the Candle Lanterns of the North add-on and try using the No BSA version instead, which has assisted many with script execution problems such as this.

////////////////COMPATIBILITY:

Incompatible with mods that edit the candle lantern static objects found throughout Skyrim.